Headings

Originally named the ATX heading, a Heading communicates a central idea for a topic. Headings should contain the main idea for a section, and have useful keywords to make the section easy to find in a search.

Syntax

Headings are created by starting a line of content with the # character. The # characters and the text content of the Heading need to be separated by a space character. The amount of # characters used indicates the level of heading which will be created.

Basics

Create a Heading 1 with a single #, a space, and some text.

# Heading 1

More # characters can be added to the Heading to increase the heading level, up to 6.

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

Markdown++

A custom Paragraph Style can be given to a Heading using a Markdown++ style: command on the line directly above the Heading.

<!--style:CustomHeading-->
# Heading 1

To learn more about Markdown++ tagging, see Learning Markdown++.

Heading Behavior

Heading Alias

Each created Heading gets an alias that can be used to link to it from another place in the publication.

To determine the alias value, ePublisher takes the text of the Heading, lower-cases it, removes all non-alphanumeric characters, and replaces space with - characters.

The below Heading will get the alias value lets-go-to-the-moon.

# Let's Go to the Moon!

Any time the text of a Heading is changed, the alias will also change. It's recommended to use a Custom Alias to avoid having to change link paths when Headings change.

ePublisher Style Information

Style Behavior

The style name ePublisher will create for a Heading will is dependent on the number of # characters used at the front of the line. One # character creates the style name Heading 1, two # characters creates Heading 2, etc.

Default Style Properties

Style Type: Paragraph
Style Name: Heading 1, Heading 2, Heading 3, Heading 4, Heading 5, Heading 6

Heading 1

Heading 2

Heading 3

Heading 4, Heading 5, Heading 6

Default Style Options

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

If a custom style name is assigned to a Heading, that style name will still inherit all of the listed default style information for the matching Heading syntax.